home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / science / maths / calc / readme.amiga < prev    next >
Encoding:
Text File  |  1996-09-07  |  3.1 KB  |  92 lines
  1. This is the README file for the Amiga port of the calc package.
  2.  
  3. 1. INSTALLATION
  4.  
  5. Sorry, no Install script.  But, installation is really trivial.
  6. Just unarchive and put the directory anywhere you want.  Now you have
  7. two options:
  8.  
  9.     1. Add a an Assign to your User-Startup:
  10.  
  11.         Assign CALCDIR: DH1:Applications/Calc  (or whatever)
  12.  
  13.     2. Set up Environment variables as shown below.
  14.  
  15. Then move the calc executable to a directory in your path or add
  16. CALCDIR: to your path.
  17.  
  18. If you don't want the source code cluttering up your disk, just delete
  19. the 'source' directory.
  20.  
  21. 2. DIFFERENCES
  22.  
  23. The Amiga port is almost identical to the original UNIX version, without
  24. requiring ixemul.library.  The original input line history and editing stuff
  25. was removed.  If you use KingCON is supplies all these services anyway.
  26.  
  27. An environment variable was added for the help directory.
  28.  
  29. A new function was added called chkabort(). It takes no arguements and
  30. just checks to see if CTRL-C was pressed, and if so it exits the program.
  31. This was added because otherwise the CTRL-C check is only performed
  32. when doing I/O.  This means that there is no way to stop the program if
  33. it is in the middle of a long loop.  The solution: if you have a loop
  34. if indeterminate length that does no I/O, call this function in the loop
  35. to check for CTRL-C.
  36.  
  37. 3. ENVIRONMENT VARIABLES
  38.  
  39. Calc checks for the following environment variables.  If they don't
  40. exist, the indicated defaults are used.
  41.  
  42. Variable    Use                Default
  43. --------    ------------------------------    ---------------
  44. CALCPATH    colon-separated list of        ";CALCDIR:lib/"
  45.         dirs to search for input files
  46. CALCRC        colon-separated list of files    "CALCDIR:lib/startup;S:.calcrc"
  47.         to load on startup
  48. CALCHELP    dir containing help files    "CALCDIR:help/"
  49. PAGER        program to see help files    "more"
  50.  
  51. 4. BUGS
  52.  
  53. The program doesn't react gracefully when asked to provide help for which
  54. there is no on-line help file.  This behaviour is dependant on the pager
  55. you specify in the PAGER environment variable.
  56.  
  57. The program is compiled without support for a math coprocessor since I don't
  58. have one.  I'll compile one for anyone who asks, but I can't debug it if it
  59. has problems.  Sorry.
  60.  
  61. No Installer script.
  62.  
  63. Not much Amiga-specific documentation
  64.  
  65. 5. DOCUMENTATION
  66.  
  67. There is a formatted man page in this directory, modified with Amiga-
  68. specific information.  There are also README files in the lib and source
  69. directories.  Finally, there is online help in the help directory.
  70.  
  71. 6. CLOSING
  72.  
  73. The original source code can be obtained from
  74.     ftp://ftp.uu.net/pub/calc/
  75.  
  76. Please don't hesitate to send me email if you have questions or suggestions
  77. about the port.  I'll maintain this for my own satisfaction but no more
  78. than that, unless dozens of people write in to tell me that ther're using
  79. calc.
  80.  
  81. The following tools were used to port this program:
  82.     FrexxEd 1.10
  83.     SAS/C 5.10
  84.     BDebug 1.682
  85.  
  86. -- 
  87. +---------------------------------------------------------------------------+
  88. | Steve Leblanc | He softly and silently vanished away,                     |
  89. | lupus@CAM.ORG | For the Snark _was_ a Boojum, you see.     Lewis Carroll  |
  90. +---------------------------------------------------------------------------+
  91.  
  92.